SftTree/OCX 7.0

SftTree.ButtonAppearance Property

Softel vdm, Inc.

Defines the expand/collapse button appearance.

Syntax       

Get

VB.NET

Style = object.ButtonAppearance  As SftTreeButtonAppearanceConstants

VB

Style = object.ButtonAppearance  As SftTreeButtonAppearanceConstants

C#.NET

SftTreeButtonAppearanceConstants Style = object.ButtonAppearance;

VC++

enum SftTreeButtonAppearanceConstants Style = object->ButtonAppearance;
enum SftTreeButtonAppearanceConstants Style = object->GetButtonAppearance();

C

HRESULT object->get_ButtonAppearance(enum SftTreeButtonAppearanceConstants* Style);

Delphi

Style := object.ButtonAppearance  : TOleEnum;

Put

VB.NET

object.ButtonAppearance = Style  As SftTreeButtonAppearanceConstants

VB

object.ButtonAppearance = Style  As SftTreeButtonAppearanceConstants

C#.NET

SftTreeButtonAppearanceConstants object.ButtonAppearance = Style;

VC++

enum SftTreeButtonAppearanceConstants object->ButtonAppearance = Style;
void object->PutButtonAppearance(enum SftTreeButtonAppearanceConstants Style);

C

HRESULT object->put_ButtonAppearance(enum SftTreeButtonAppearanceConstants Style);

Delphi

object.ButtonAppearance := Style  : TOleEnum;

object

A SftTree object.

Style

Defines the expand/collapse button appearance.

Style

Value

Description

buttonsSftTreeUserImages

-1

User defined button images - Expand/collapse buttons are defined using the properties ButtonExpanded, ButtonCollapsed (and optionally the properties ButtonExpandedDown, ButtonCollapsedDown, ButtonExpandedHot, ButtonCollapsedHot).

buttonsSftTreeClassicSmall

0

Classic small button - Small gray button image with + and - symbols.

buttonsSftTreeClassicWide

1

Classic wide button - Wide gray button image with + and - symbols.

buttonsSftTreeClassicLarge

2

Classic large buttons - Large gray button image with up and down symbols

buttonsSftTreeSimple

3

Simple - White box with + and - symbols, similar to Windows Explorer on Windows 98/ME/2000

buttonsSftTreeModern

4

Modern (using bitmaps) - The button style is not based on a bitmap.  It is determined by the Windows release and is rendered by Windows.  Note: On Windows XP and above, the button will always be rendered using the buttonsSftTreeClassicSmall style, as standard buttons supported by most themes are not suitable for use as expand/collapse buttons due to their small size.

buttonsSftTreeThemeImitation

5

Theme imitation (using bitmaps) - Button image as used on Windows XP. This style is not limited to Windows XP as it is based on a bitmap. No actual Windows themes are used.

buttonsSftTreeAutoThemeImitation

6

Automatic theme imitation (using bitmaps) - Depending on the Windows version and available features, the control selects the appropriate button style. On Windows XP (and above) with themes, buttonsSftTreeThemeImitation is selected. On all other Windows versions or if themes are not available, buttonsSftTreeModern is selected.

buttonsSftTreeAutoTheme

7

Automatic theme - Depending on the Windows version and available features, the control selects the appropriate button style.  On Windows XP (and above) with themes, the button image is rendered using the currently selected Windows theme. On all other Windows versions or if themes are not available, buttonsSftTreeSimple is selected. A Windows Vista themed button looks like a Windows XP button. For a look similar to Windows Explorer on Windows Vista, select buttonsSftTreeAutoThemeVista instead.

buttonsSftTreeAutoThemeVista

8

Automatic theme (Vista) - Depending on the Windows version and available features, the control selects the appropriate button style. On Windows XP with themes, the button image is rendered using the currently selected Windows theme. On Windows Vista with themes, a look similar to Windows Explorer is used (based on GDI+ images). On all other Windows versions or if themes are not available, buttonsSftTreeSimple is selected.

Comments

The ButtonAppearance property defines the expand/collapse button appearance.

All items use the same expand/collapse bitmap. Expand/collapse buttons are only shown if enabled using ButtonStyle.

Sample bitmaps for expand/collapse buttons are provided in the directory \Program Files\Softelvdm\SftTree OCX 7.0\Images.

See Also  SftTree Object | Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com